home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / comm / net / AMarquee1_46.readme < prev    next >
Text File  |  1998-01-05  |  8KB  |  153 lines
  1. Short:    TCP Data broadcast system w/ARexx support!
  2. Author:   jfriesne@ucsd.edu (Jeremy Friesner)
  3. Uploader: jfriesne@ucsd.edu (Jeremy Friesner)
  4. Version:  1.46
  5. Type:     comm/net
  6. Replaces: comm/net/AMarquee1.45.lha
  7. Requires: Workbench 2.04+, Inet225 or AmiTCP3.0b+ or compatible TCP stack
  8.  
  9. ----------------------------------------------------------------
  10.         
  11.                           AMARQUEE v1.46
  12.                      
  13.                         (Released 12/7/97)
  14.                      
  15. ----------------------------------------------------------------
  16.  
  17.  
  18. The Problem: 
  19.  
  20.  You have a great idea for a killer multi-player Internet game 
  21.  or multi-user net app, but it's a total pain in the @)#$* to 
  22.  write all the TCP connection and data synchronization code 
  23.  you'll need to get it going.  So you put your idea on the 
  24.  back-burner and go play "Lemmings" instead.  And thus the 
  25.  Amiga is deprived of a fun Internet app.  D-oh!  :(
  26.  
  27. The Solution:  (well, okay, it's *a* solution, anyway)
  28.  
  29.  AMarquee is a system that handles all of the icky information 
  30.  distribution details for you, allowing you to concentrate on 
  31.  coding your application, rather than on which data goes into 
  32.  which socket when.  AMarquee consists of a shared library and 
  33.  a TCP daemon, which work together to get your data where it 
  34.  needs to be.  Your program simply calls amarquee.library 
  35.  functions to broadcast the data, and waits on a provided 
  36.  MsgPort for data from other hosts.  Easy!
  37.  
  38.  
  39. Features of amarquee.library (the shared library/API):
  40.  
  41.  - Programs written to use amarqeue.library will work transparently
  42.    with Inet225, AmiTCP, Miami, or any stack that is "AmiTCP compatible".
  43.  - Simple API requires no knowledge of socket programming to use.
  44.  - Each AMarquee connection you make automatically and transparently
  45.    starts a separate execution thread, so your app will never
  46.    be forced to wait while data is sent or received.
  47.  - An arbitrary number of connections may be active at once.
  48.  - Allows you to "subscribe" to data that interests you, so that
  49.    when the data on the server is changed you will be automatically 
  50.    notified.  You never need to poll for anything!
  51.  - An easy mechanism for sending messages to one or many other
  52.    AMarquee clients that are logged into the same server.
  53.  - Standard Amiga wildcarding is supported in all applicable functions.  
  54.    This allows you to easily and succinctly refer to one host or data 
  55.    item, or many, as appropriate.
  56.  - #includes for both C and PCQ Pascal are included.
  57.  - ARexx accessible.  That is, ARexx scripts can use amarquee.library
  58.    for communications using the same API that compiled programs do.
  59.  - Example programs in C, Pascal, and ARexx are included.
  60.  - Operation is almost totally asynchronous for efficiency, but
  61.    several easy synchronization methods are available if you need them.
  62.  - Can also be used for direct client-to-client connections and
  63.    for making inetd-launched or manually-launched daemon programs.
  64.  - Automatically detects when the remote computer has crashed or
  65.    been shut down, even on idle connections.
  66.  
  67. Features of AMarqueed (the AmiTCP server):
  68.  
  69.  - Works with Inet225, AmiTCP, Miami, or any other stack that is 
  70.    "AmiTCP compatible".
  71.  - Fully multithreaded design, with one server process per connection.
  72.  - Re-entrant code, to minimize memory usage.
  73.  - Data is stored in a filesystem-like tree structure for simplicity,
  74.    flexibility and efficiency.  Each client gets its own "home directory"
  75.    that it may write to or read from, and each client may also
  76.    read from the "home directories" of other clients.
  77.  - Efficient design minimizes CPU usage, net bandwidth, and execution time.
  78.  - Limits may be put on memory usage, number of connections, and/or 
  79.    which clients or apps may connect.  Only serve the hosts and apps
  80.    you want to serve!
  81.  - Supports data streaming to one or many clients at once.
  82.  - Data streaming and synchronization features let you be sure your 
  83.    data was read by all interested hosts before you update it again.
  84.  - Automatically detects and eliminates "dead" connections (e.g.
  85.    if the client computer was shut down without quitting politely)
  86.  
  87. WHAT'S NEW IN VERSION 1.46:
  88.  
  89.  - ARexx support!  amarquee.library is now usable by ARexx scripts.
  90.  - Added the QGetAndSubscribeOp() function to amarquee.library.
  91.  - Added amarqueedebug.rexx, amarqueehost.rexx, sysmessage.rexx,
  92.    and killclients.rexx to the sample programs directory.
  93.  * QNewHostSession() was broken under Inet225.  Fixed it.  (Thanks
  94.    to Raj for reporting this!)
  95.  * Fixed a minor bug that would cause an unwarranted update message
  96.    to be sent to any client that had received a QMessageOp message
  97.    from a client whose root node it was monitoring via QSubscribeOp.  
  98.  * Fixed a bug in AMarqueed that prevented QRenameOp events from
  99.    being broadcast to other clients correctly--the deletion of
  100.    the old name would be sent, but not the creation of the new one.
  101.  
  102.  
  103. ============================= Archive contents =============================
  104.  
  105. Original  Packed Ratio    Date     Time    Name
  106. -------- ------- ----- --------- --------  -------------
  107.     1233     595 51.7% 06-Dec-97 13:01:38  AMarquee.info
  108.   147697   41979 71.5% 06-Dec-97 13:01:40 +amarquee.guide
  109.     1542    1096 28.9% 06-Dec-97 13:01:40 +AMarquee.guide.info
  110.    31004   16383 47.1% 06-Dec-97 13:01:38 +amarquee.library
  111.    31172   16454 47.2% 06-Dec-97 13:01:40 +amarquee.library.inet225
  112.     4940    2226 54.9% 06-Dec-97 13:01:36 +AMarquee.readme
  113.      835     268 67.9% 06-Dec-97 13:01:38 +AMarquee.readme.info
  114.    40420   21250 47.4% 06-Dec-97 13:01:38 +AMarqueed
  115.    40456   21270 47.4% 06-Dec-97 13:01:38 +AMarqueed.inet225
  116.     4123    1604 61.0% 06-Dec-97 13:01:42 +EditTextFile.rexx
  117.    10976    6286 42.7% 06-Dec-97 13:01:42 +AMarqueeDebug
  118.     7166    2349 67.2% 06-Dec-97 13:01:44 +amarqueedebug.c
  119.     7028    2283 67.5% 06-Dec-97 13:01:46 +amarqueedebug.rexx
  120.     9200    5495 40.2% 06-Dec-97 13:01:44 +AMarqueeHost
  121.     4175    1563 62.5% 06-Dec-97 13:01:42 +amarqueehost.c
  122.     6380    2123 66.7% 06-Dec-97 13:01:42 +amarqueehost.rexx
  123.    11868    6923 41.6% 06-Dec-97 13:01:44 +AMarqueeServer
  124.     5307    1924 63.7% 06-Dec-97 13:01:42 +AMarqueeServer.c
  125.     7400    4731 36.0% 06-Dec-97 13:01:42 +BounceCount
  126.     2910    1167 59.8% 06-Dec-97 13:01:44 +BounceCount.c
  127.      494     262 46.9% 06-Dec-97 13:01:44 +dmakefile
  128.     2439    1114 54.3% 06-Dec-97 13:01:42 +killclients.rexx
  129.    10408    6410 38.4% 06-Dec-97 13:01:44 +MiniIRC
  130.     6379    2171 65.9% 06-Dec-97 13:01:46 +MiniIRC.c
  131.     1139     502 55.9% 06-Dec-97 13:01:44 +PascalTest.p
  132.     6984    4444 36.3% 06-Dec-97 13:01:42 +RemoveTest
  133.     2546    1035 59.3% 06-Dec-97 13:01:44 +RemoveTest.c
  134.     9324    5734 38.5% 06-Dec-97 13:01:44 +SillyGame
  135.     8214    2586 68.5% 06-Dec-97 13:01:46 +SillyGame.c
  136.     7404    4711 36.3% 06-Dec-97 13:01:44 +StreamCheck
  137.     3132    1242 60.3% 06-Dec-97 13:01:44 +StreamCheck.c
  138.     7216    4569 36.6% 06-Dec-97 13:01:44 +StreamGen
  139.     2422    1018 57.9% 06-Dec-97 13:01:44 +streamgen.c
  140.     7456    4717 36.7% 06-Dec-97 13:01:42 +SyncTest
  141.     3250    1302 59.9% 06-Dec-97 13:01:46 +SyncTest.c
  142.     2658    1181 55.5% 06-Dec-97 13:01:42 +sysmessage.rexx
  143.     3140     798 74.5% 06-Dec-97 13:01:46 +AMarquee_protos.h
  144.     1237     432 65.0% 06-Dec-97 13:01:48 +amarquee.fd
  145.     3839    1604 58.2% 06-Dec-97 13:01:46 +AMarquee.h
  146.     1775     498 71.9% 06-Dec-97 13:01:46 +AMarquee_pragmas.h
  147.    23542    5831 75.2% 06-Dec-97 13:01:40 +Install_AMarquee
  148.      612     329 46.2% 06-Dec-97 13:01:42 +Install_AMarquee.info
  149.     6919    2018 70.8% 06-Dec-97 13:01:48 +AMarquee.i
  150.     3972     579 85.4% 06-Dec-97 13:01:48 +AMarquee.lib
  151. -------- ------- ----- --------- --------
  152.   502333  213056 57.5% 06-Dec-97 23:52:06   44 files
  153.